home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 42 / Amiga Format AFCD42 (Issue 126, Aug 1999).iso / -serious- / programming / other / gui4cli / docs / changes_old < prev    next >
Text File  |  1999-05-14  |  23KB  |  575 lines
  1.  
  2.   ================================================================
  3.   === VERSION 3.6 CHANGES ------------------------------------->>>
  4.   ================================================================
  5.  
  6.   Events & Commands :
  7.  
  8. - Event : xTIMER TIME|SINGLE|REPEAT TIME|INTERVAL ON|OFF
  9.   will provide you with accurate timing events - see the guide
  10.   for details.
  11.  
  12. - ClipBoard support for text clips is now provided for listviews.
  13.   o When you load a file called Clips:0 (or any number 0-255) then
  14.     the lv will load whatever is in that clipboard unit. 
  15.   o When you save a file whose file path starts with "CLIPS:" i.e.
  16.     something like Clips:3, the lv will be saved to the given
  17.     clipboard unit in correct iff format.
  18.   o Moreover listviews will load any IFF-FTXT file correctly.
  19.  
  20. - SHAREMENU GuiName - (Global command)
  21.   Will share the menus of the named gui file. When the menu is 
  22.   selected it will be as if the other gui's (the one which has the 
  23.   actual menu events in it) menu was selected and all commands 
  24.   attached to it will be executed.
  25.  
  26. - Menus will now accept many BARLABEL items.
  27.  
  28. - Now you can give '#This' as the gui file name, and it will
  29.   mean the current file - i.e. GuiOpen #This - will mean : open
  30.   the file that this command appears in. This gives you more 
  31.   independent code.
  32.  
  33. - CONTROL-R will now execute all xOnClose/Quit/Load commands
  34.   it encounters while Re-Loading a file. Note that your gui
  35.   will not re-open if there is no guiopen command in the 
  36.   xOnLoad event.
  37.  
  38. - RESINFO FontHeight ScreenWidth ScreenHeight - is a new Global 
  39.   command with which you can give some info to Gui4Cli to enable
  40.   it to resize the gui correctly on other people's systems.
  41.  
  42. - Worked around gadtools limitation by which when you move a 
  43.   listview with the scroller and after try to continue with the 
  44.   arrow keys, it snaps back to the last record you had clicked 
  45.   on - now Gui4Cli will guess the line and scroll correctly.
  46.   
  47.   ARexx :
  48.  
  49. - There is now a global variable named *REXXVAR which has
  50.   special meaning. You use it as you would any global variable
  51.   but when someone sends a rexx command to Gui4Cli from a
  52.   rexx program which has OPTIONS RESULTS declared, then the
  53.   contents of this variable will be returned and will be
  54.   available from withing arexx as variable RESULT. So...
  55.      >> SetVar  "*REXXVAR"  "'$mygui.gc/myvar'"
  56.   ..would put whatever is in $mygui.gc/myvar into RESULT.
  57.  
  58.   Note the use of the quotes: one set for arexx, another for
  59.   Gui4Cli (since $mygui.gc/myvar could be a string of words).
  60.  
  61. - If you set OPTIONS RESULTS you will now cause the Gui4Cli 
  62.   command you have sent from an ARexx program to be executed
  63.   synchronously. This has the advantage of returning a result.
  64.   Without OPTIONS RESULTS the execution is asynchronous.
  65.  
  66. - Also fixed some Gui4Cli<->ARexx communication errors..
  67.   You can now run a rexx program with a public port and have
  68.   it communicate back and forth with Gui4Cli without the
  69.   deadlocks that used to occur.
  70.  
  71.   C Programmers Interface :
  72.  
  73. - Have provided an include file with Gui4Cli internal
  74.   structures and set up a mechanism whereby you can communicate
  75.   with Gui4Cli, and in effect provide extensions to Gui4Cli's 
  76.   command set, as follows :
  77.  
  78.   - From outside programs -to-> Gui4Cli
  79.     a) Send message and LOCK Gui4Cli, look at it's internal
  80.        structures, manipulate variables, listviews etc, and then
  81.        unlock it again, and let it continue, or
  82.     b) Send command lines for it to execute (like rexx msgs)
  83.  
  84.   - From Gui4Cli -to-> outside programs
  85.     Use the new command :
  86.     > CALL PortName Command Arg1 Arg2... Arg6
  87.     to send special Gui4Cli messages containing commands
  88.     to outside programs, who should then process the commands
  89.     using, if they want, any of Gui4Cli's internal structures,
  90.     and give control back to Gui4Cli (maybe returning something)
  91.  
  92.   See the examples in the "Guis:Ext" directory for more info.
  93.  
  94.   IMPORTANT NOTE : 
  95.   - Changes have been made to the structures of the BETA version 
  96.     that was on my page !!! - Recompile or crash.
  97.  
  98.  Extensions :
  99.  
  100.   Two extensions can already be found in guis:ext :
  101.  
  102. - GCSound - a 8SVX sample player (mono only for now) with the
  103.   ability to load & play many samples simuiltaneously, change
  104.   speed & volume while playing etc - Full gui is available in
  105.   the same directory.
  106.  
  107. - LVFormat - various functions which act on the current listview
  108.   like : wordwrap, indent, justify etc
  109.  
  110.  New internal variables :
  111.  
  112.   $$SYS.AW  - Active Window Title (may or may not be a Gui4Cli window)
  113.   $$SYS.AS  - Active Screen title
  114.   $$SYS.ASN - Active Screen Name (if it's public)
  115.   $$SYS.FS  - Frontmost Screen Title 
  116.   $$SYS.FSN - Frontmost Screen Name (if it's public)
  117.   If you need other data (width etc) you can SetScreen the current 
  118.   gui to the name you want (no need to open it) and read the 
  119.   $$SRC.xx vars.
  120.  
  121.   $$SYS.TIME - the current time (ex: 10:30:25 - hh:mm:ss)
  122.   $$SYS.TS   - the seconds part of the above time (i.e. 25)
  123.   $$SYS.TM   - the minutes part (i.e. 30)
  124.   $$SYS.TH   - the Hours part (i.e. 10)
  125.  
  126.   $$SYS.DATE - the date (see below for formats)
  127.   - following available *only* for dd-mm-yy (CDN) format:
  128.   $$SYS.DD   - the Day part of the above date
  129.   $$SYS.DM   - the month part
  130.   $$SYS.DY   - the year part
  131.  
  132.   $$SYS.DAY  - the day of the week (i.e. Monday)
  133.  
  134.   By default the date format is DD-MM-YY (15-07-98)
  135.   You can change this with the SET command :
  136.   > SET DATEFORMAT number - where number can be:
  137.   0 = DOS format -> dd-mmm-yy  (15-Apr-98)
  138.   1 = INT format -> yy-mm-dd
  139.   2 = USA format -> mm-dd-yy
  140.   3 = CDN format -> dd-mm-yy (default)
  141.   NOTE : the $$SYS.DD/DM/DY vars aply *only* to CDN format!
  142.  
  143.   Bug fixes :
  144.  
  145. - Fixed 10 enforcer hits, only 1 of which was of any real danger,
  146.   and you can thank Giuseppe Chillemi for pointing them out to me.
  147.   Gui4Cli is now clean with Enforcer (until the next bug..)
  148.   Also fixed an enforcer hit in c:gui.
  149.  
  150. - Not actually a bug.. Now RUN will also receive a console which
  151.   will be opened every time something is RUN.
  152.  
  153. - Got the SAS 6.58 patch and recompiled, optimized and caught a
  154.   few other small bugs too..
  155.  
  156. - LVSearch will now stop at every string found - if there are many
  157.   instances of a string in a lv line. The $$search.pos etc internal 
  158.   vars will show the position & length correctly. ** fixed again **
  159.   
  160. - Fixed ReadVar trash if it read less than you asked for.
  161.  
  162. - xICON can now be setgad HIDE|SHOW (had forgoten to put it..)
  163.  
  164. - Fixed some GuiEditing graphics errors. 
  165. - Also xICON new positions will now be saved (again forgoten)
  166.  
  167. - SET DEBUGSTEP ON|OFF, will cause an easy requester to appear 
  168.   before every command is executed (in debug mode) so you can 
  169.   control execution (I used this for catching the enforcer bugs)
  170.  
  171. - Setwintitle will now work even if window is not open.
  172.  
  173. - Fixed a bug where messages returned from launches & pipes got
  174.   confused with messages replied from AREXX and could lock Gui4Cli.
  175.  
  176. - makedir will no long be confused if there is a / at the end
  177.  
  178. - Fixed bug reported by Chris Ralph, where LVINSERT increased
  179.   the total record count by 2 instead of 1
  180.  
  181.   ================================================================
  182.   === VERSION 3.5 CHANGES ------------------------------------->>>
  183.   ================================================================
  184.  
  185.   Mathematical Abilities :
  186.  
  187. - Added mathematical expression evaluation and floating point numbers.
  188.   You can now enclose an expression in brackets with a $ in front
  189.   and Gui4Cli will evaluate it. Variables can be included :
  190.      var = $(45*7.45+($OtherVar /25))
  191.      say 'The answer is: $($var *2)\n'
  192.   Moreover, inside the brackets you can use the math functions :
  193.   abs(), sin(), cos(), tan(), log(), ln(), exp(), 'pi', etc
  194.  
  195.   - BECAREFULL with variables..
  196.   You must leave a space or ')' or '(' or '\' after the var 
  197.   name otherwise Gui4Cli will not read the var name correctly.
  198.      say '$($var*2)\n'  <- is incorrect (the var name is "var*2")
  199.   Read more in "Important Topics"
  200.  
  201.   Database ListViews :
  202.  
  203. - ListViews ca